home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / cpio.man < prev    next >
Encoding:
Text File  |  1990-12-12  |  5.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. CPIO                      User Commands                      CPIO
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      cpio - copy file archives in and out
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ccppiioo --oo [ aaBBccvv ]
  13.      ccppiioo --ii [ bbBBccddffmmrrssSSttuuvv66 ] [ _p_a_t_t_e_r_n_s ]
  14.      ccppiioo --pp [ aaddllmmuuvv ] _d_i_r_e_c_t_o_r_y
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      ccppiioo copies files in to and out from a ccppiioo copy archive.
  18.      The archive (built by `ccppiioo --oo') contains pathname and
  19.      status information, along with the contents of one or more
  20.      archived files.
  21.  
  22. OOPPTTIIOONNSS
  23.      --oo   Copy out an archive.  Read the standard input for a
  24.           list of pathnames, then copy the named files to the
  25.           standard output in archive form - including pathname
  26.           and status information.
  27.  
  28.           aa    Reset the access times of input files after they
  29.                have been copied.
  30.  
  31.           BB    Output is to be blocked at 5120 bytes to the
  32.                record.  This does not apply to the _p_a_s_s option.
  33.                This option is only meaningful with data directed
  34.                to raw magnetic devices, such as `//ddeevv//rrmmtt?'.
  35.  
  36.           cc    Write _h_e_a_d_e_r information in ASCII character form
  37.                for portability.
  38.  
  39.           vv    Verbose. A list of filenames is displayed.  When
  40.                used with the tt option, the table of contents
  41.                looks like the output of an `llss --ll' command (see
  42.                llss(1V)).
  43.  
  44.      --ii   Copy in an archive.  Read in an archive from the stan-
  45.           dard input and extract files with names matching
  46.           filename substitution _p_a_t_t_e_r_n_s, supplied as arguments.
  47.  
  48.           _p_a_t_t_e_r_n_s are similar to those in sshh(1) or ccsshh(1), save
  49.           that within ccppiioo, the metacharacters `??', `**' and `[[
  50.           ... ]]' also match the `//' (slash) character.  If no
  51.           _p_a_t_t_e_r_n_s are specified, the default is ** (select all
  52.           files).
  53.  
  54.           bb    Swap both bytes and half-words after reading in
  55.                data.
  56.  
  57.           BB    Input is to be blocked at 5120 bytes to the
  58.                record.  This does not apply to the _p_a_s_s option.
  59.                This option is only meaningful with data received
  60.  
  61.  
  62.  
  63. Sprite v1.0             6 September 1988                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CPIO                      User Commands                      CPIO
  71.  
  72.  
  73.  
  74.                from raw magnetic devices, such as `//ddeevv//rrmmtt?'.
  75.  
  76.           dd    Create directories as needed.
  77.  
  78.           ff    Copy in all files except those matching _p_a_t_t_e_r_n_s.
  79.  
  80.           mm    Retain previous file modification time.  This
  81.                option is ineffective on directories that are
  82.                being copied.
  83.  
  84.           rr    Interactively rename files.  If the user types a
  85.                null line, the file is skipped.  May not be used
  86.                with the --pp option.
  87.  
  88.           ss    Swap bytes after reading in data.
  89.  
  90.           SS    Swap halfwords after reading in data.
  91.  
  92.           tt    Print a table of contents of the input archive.
  93.                No files are created.
  94.  
  95.           uu    Copy unconditionally.  Normally, an older file
  96.                will not replace a newer file with the same name.
  97.  
  98.           66    Process UNIX Version-6 files.
  99.  
  100.      --pp   One pass.  Copy in and out in a single operation.  Des-
  101.           tination pathnames are interpreted relative to the
  102.           named _d_i_r_e_c_t_o_r_y.
  103.  
  104.           ll    Whenever possible, link files rather than copying
  105.                them.
  106.  
  107. EEXXAAMMPPLLEESS
  108.      To copy the contents of a directory into an archive:
  109.  
  110.           eexxaammppllee%% llss || ccppiioo --oo >> //ddeevv//mmtt00
  111.  
  112.      To read a cpio archive from a tape drive:
  113.  
  114.           eexxaammppllee%% ccppiioo --iiccddBB << //ddeevv//rrmmtt00
  115.  
  116.      To duplicate the oollddddiirr directory hierarchy in the nneewwddiirr
  117.      directory:
  118.           eexxaammppllee%% ccdd oollddddiirr
  119.           eexxaammppllee%% ffiinndd .. --ddeepptthh --pprriinntt || ccppiioo --ppddll nneewwddiirr
  120.  
  121.      The trivial case
  122.           eexxaammppllee%% ffiinndd .. --ddeepptthh --pprriinntt || ccppiioo --ooBB >>//ddeevv//rrmmtt00
  123.  
  124.      can be handled more efficiently by:
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0             6 September 1988                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CPIO                      User Commands                      CPIO
  137.  
  138.  
  139.  
  140.           eexxaammppllee%% ffiinndd .. --ccppiioo //ddeevv//rrmmtt//00mm
  141.  
  142.      ccppiioo archive tapes from other sites may have bytes swapped
  143.      within the archive.  Although the --iiss option only swaps the
  144.      data bytes and not those in the header ccppiioo recognizes tapes
  145.      like this and swaps the bytes in the header automatically.
  146.  
  147. SSEEEE AALLSSOO
  148.      aarr(1V), ccsshh(1), ffiinndd(1), llss(1V), sshh(1), ttaarr(1), ccppiioo(5)
  149.  
  150. BBUUGGSS
  151.      ccppiioo does not support multiple volume tapes.
  152.  
  153.      Pathnames are restricted to 128 characters.  If there are
  154.      too many unique linked files, ccppiioo runs out of memory and
  155.      linking information is lost thereafter.  Only the super-user
  156.      can copy special files.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0             6 September 1988                        3
  196.  
  197.  
  198.  
  199.